home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dirut / wiz29.zip / WIZ.DOC < prev    next >
Text File  |  1994-04-21  |  35KB  |  943 lines

  1.  
  2.                 WIZ version 2.9
  3.                by Ray Van Tassle
  4.                1020 Fox Run Lane
  5.              Algonquin, Ill, 60102
  6.                 (708)-658-4941
  7.                    April 10, 1994
  8.  
  9.     WIZ program and manual copyright(c) 1990-1994 by Ray Van Tassle.
  10.  
  11.     Abstract:
  12.     WIZ is a lightning-fast file finder. It will find file(s)
  13.     based on full wildcard specifications (more powerful than
  14.     standard DOS wildcard), and can also filter by file size
  15.     and date.  It can:
  16.        * select only executable files (EXE, COM, BAT).
  17.        * select only archive files (ZIP, ARC, etc.)
  18.        * switch you to the disk\directory of a file that it found.
  19.        * execute a DOS command for each file it finds.
  20.        * look inside archives (ZIP, LZH, & ARJ)
  21.        * recursively look inside archives!
  22.        * Correct handling of the special files/directories created and
  23.          maintained by STACKER, DoubleDisk, DoubleSpace,
  24.          Norton FILESAVE, and PCTOOLS DATA Sentry.
  25.  
  26.     It will look on multiple disk drives for all matching
  27.     filenames.  You can pre-specify several default lists of
  28.     disk drives for it to search.
  29.  
  30.  
  31.     WIZ program and manual copyright(c) 1990-1994 by Ray Van Tassle.
  32.  
  33.     WIZ is shareware, NOT freeware!!!
  34.  
  35.     You are granted a limited 21 day evaluation license. At the end
  36.     of that period, you should either delete it and stop using it,
  37.     or send in the registration fee of $20 ($15 if you don't want me to
  38.     send you a disk).
  39.  
  40.  
  41.  
  42.     MANUAL
  43.     ------
  44.     I was tempted to call this program YAFF (yet another file
  45.     finder), but I settled on WIZ.  This is a funny acronym for
  46.     "where is". But it's also short for WIZARD, because it's so
  47.     fast it seems like magic, and it's filename matching is so
  48.     powerful.
  49.  
  50.     It looks on one or more disks for all filenames (including
  51.     directories) that match the specified filename. By default, it
  52.     starts on drive C, and goes up until it runs out of disks.
  53.  
  54.     It has been tested, and works, with DOS 3.x, including Zenith
  55.     DOS 3.30, DOS 3.31, DOS 4.01, DOS 5.0, DOS6.2, and On-Track
  56.     partitioning software.  DOS 3.31+ have large
  57.     (greater than 32MB) partitions with more than 65,536 sectors.
  58.     Zenith DOS 3.30 and On-Track have large partitions by virtue of
  59.     using large sectors (1024, 2048, or 4096 bytes, rather than
  60.     512 bytes).
  61.  
  62.     WIZ normally prints out, for each matching file, the filename,
  63.     date, time, size, and path.  The files are NOT ordered or
  64.     sorted.  All "special" files (hidden, system) are
  65.     flagged with a left-pointing triangle after the filename.
  66.     Optionally, it will list the files in normal fully-pathed form
  67.     (e.g., C:\UTIL\PGMS\ABC.BAT), suitable for processing by a
  68.     program which expects normal filenames.  When the found file
  69.     is inside an archive (-l flag), it will be listed in a form
  70.     suitable for the archiver (e.g.,
  71.     "C:\UTIL\PGMS\FOO.ZIP FILE.EXE")
  72.  
  73.     I deemed that most of the time, people (including me) want it
  74.     to be FAST, rather than in some particular order.
  75.     As WIZ reads the disk, it tries to optimize the head
  76.     motion, so directories are not processed in order of path, but
  77.     in the order that WIZ thinks will be quickest.  However, it will
  78.     generally look at the files in a directory before it looks at
  79.     the sub-directories.  However (especially if you have
  80.     directories with lots of files and sub-directories), it may
  81.     show some files in a directory, then show sub-directories, then
  82.     show more files in the directory.
  83.  
  84.     WIZ will ignore STACKER, DUBLDISK, and DOUBLESPACE container 
  85.     files in the count of files & MB's scanned.  This file has 
  86.     attributes of RHS, and is named "STACVOL.0??", "DUBLSPAC.0??", 
  87.     or "DBLSPACE.0??"
  88.     
  89.     Likewise, WIZ will ignore the special hidden directories where
  90.     Norton's "FILESAVE" and PCTOOLS "DATAMON/SENTRY" move files that
  91.     have been deleted.  These tools & their directories are a super
  92.     undelete, and they are reported by DOS to have been deleted, but
  93.     the respective utilities really just have them tucked away in a
  94.     hidden place.  So WIZ treats these files as not being there, too.
  95.     
  96.  
  97.  
  98.     PERFORMANCE & Comparison with other file-find programs
  99.     ------------------------------------------------------
  100.     Some tests, run on a 486/33mhz, searching for a non-existent
  101.     file on a large disk partitioned into drives C thru J,
  102.     17,000 total files, 747MB in files, in 572 directories.
  103.  
  104.     WIZ 2.9        Target15    FFF45
  105.     -------        --------    -----
  106.     19.1        83.3        53.1    No cache
  107.     
  108.        The command used were:
  109.         WIZ c-j:*qwe*
  110.         TARGET -e -hidden cdefghij: "qwe"
  111.         FFF /e cdefghij: ".*qwe.*"
  112.     
  113.        Notes:
  114.         TARGET claims to have real regexp's but they aren't.
  115.         FFF appears to have real regexp's.
  116.     
  117.  
  118.     When used with a disk cache, of 2MB (2048K).
  119.  
  120.     WIZ 2.9        Target15    FFF45
  121.     -------        --------    -----
  122.     18.7        44.3        40.2    PC-CACHE v6.01
  123.      1.3        16.3         8.3     " 2nd command
  124.  
  125.     19.7        37.4        30.2    SMARTDRV v5.0
  126.     19.5        37.8        29.8     " 2nd command
  127.  
  128.     19.7        83.3        50.9    HYPER386 v4.65 
  129.     16.1        53.5        36.7
  130.  
  131.        The first line is just after clearing the cache.
  132.        The next is running the same command again, giving maximum 
  133.        advantage to the cache. In my testing, I have found that PC-CACHE 
  134.        seems to provide the best all-around performance.
  135.        In fact, with WIZ, SMARTDRV actually takes longer!!  Starting with 
  136.        WIZ v2.9, it momentarily disables SMARTDRV while it scans a disk.
  137.        
  138.  
  139.     ERRORLEVEL exit codes
  140.     ---------------------
  141.     0 = Normal exit.
  142.     1 = Normal exit. -g changes disk/path
  143.     2 = Bad command line.
  144.     255 = Internal error.
  145.  
  146.  
  147.     Error Messages
  148.     --------------
  149.     "INVALID directory:"
  150.         Encountered what appears to be an illegal directory
  151.         entry.  This is a clue for a corrupted disk, or a file
  152.         which is NOT a directory masquerading as one.
  153.  
  154.         "Can't tell if FAT-12 or FAT-16. Assuming FAT-16!"
  155.         Just what it says.  I've only seen this on networked
  156.         disk drives.  If you know how to RELIABLY tell what
  157.         type of FAT a disk has (other than going thru DOS),
  158.         please let me know.
  159.  
  160.     "malloc failed for FAT_buf!"
  161.         Can't allocate memory to read a FAT block.  Most
  162.         likely an internal error.
  163.  
  164.      "malloc failed for dir_sec_buf!"
  165.         Can't allocate memory to read in a directory sector.
  166.         Most likely an internal error.
  167.  
  168.     "Sorry, out of memory!!!"
  169.         You lose.
  170.  
  171.     "Can't open file:"
  172.         Failure to open an archive file.  Most likely a disk
  173.         error. Run CHKDSK.
  174.  
  175.     "Internal error in ZIP/LZH/ARJ file"
  176.         The data read from in archive file isn't as expected.
  177.         Most likely the archive has a new format, and WIZ
  178.         hasn't yet been updated.  'Course, the archive file
  179.         may be corrupted.
  180.  
  181.     "INVALID directory"
  182.         A sub-directory (whose name is displayed) is not valid.
  183.         Your directory structure has been corrupted.  You should
  184.         run a utility to fix it--Norton NDD or PC-TOOLS DISKFIX.
  185.  
  186.     "Can't recurse in this!"
  187.         The archive file cannot be recursively searched, because
  188.         it is compressed.
  189.  
  190.     NETWORK DRIVES
  191.     --------------
  192.     WIZ has been tested, and runs ok under several networks: 
  193.     Pathworks (Digital Equipment Corp), $25Network (Information Modes),
  194.     EBOX (Rupp).
  195.     Version 2.7 works on Novell, Lantastic, and other networks.
  196.  
  197.     CD-ROMS
  198.     -------
  199.     WIZ works on CD-ROM's.
  200.  
  201.     BUGS
  202.     ----
  203.     No known bugs.  However, WIZ mostly does not use DOS to
  204.     process a disk, so errors on my part, or a change in the disk
  205.     structure might break it.  The most major bug reported was on
  206.     huge disk partitions under MS-DOS 4.01.  This bug caused WIZ
  207.     to read a random block from the disk, and treat it as a
  208.     directory.  It made a valiant attempt to march down all the
  209.     phony sub-directories, and would actually run for quite a
  210.     while before printing one of the "malloc failure" messages.
  211.  
  212.     If you are having problems, try 1) use the "-v" switch, to
  213.     isolate the error to a specific disk,  2) use "-vv", to see
  214.     as it hits each sub-directory,  3) use "*.*" to see all the
  215.     files, and watch until it walks off the edge of the world.
  216.     Then call or write me.
  217.  
  218.  
  219.     Command Line format and Switches
  220.     --------------------------------
  221.  
  222.     WIZ [disks:]file_pattern [-sN] [-dN] [-p] [-pp] [-gN] [-x] [-mN] 
  223.         [-e] [-qS] [-n] [-4]
  224.         [-a] [-v] [-l[b][l]]  [-cS] [-?] [>output-file-name]
  225.  
  226.